By default a log file named _p_m_c_d._l_o_g is written in the directory
/_v_a_r/_a_d_m/_p_c_p_l_o_g (else the directory identified by the PPPPCCCCPPPP____LLLLOOOOGGGGDDDDIIIIRRRR
environment variable). The ----llll option causes the log file to be
written to _l_o_g_f_i_l_e instead of the default. If the log file cannot
be created or is not writable, output is written to the standard
error instead. The ----llll option specifies an alternative name for the
log file.
----qqqq _t_i_m_e_o_u_t
The pmcd to agent version exchange protocol (new in PCP 2.0 -
introduced to provide backward compatibility) uses this timeout to
specify how long pmcd should wait before assuming that no version
response is coming from an agent. If this timeout is reached, the
agent is assumed to be an agent which does not understand the PCP
2.0 protocol. The default timeout interval is five seconds, but the
----qqqq option allows an alternative timeout interval (which must be
greater than zero) to be specified. The unit of time is seconds.
----tttt _t_i_m_e_o_u_t
To prevent misbehaving agents from hanging the entire Performance
Metrics Collection System (PMCS), ppppmmmmccccdddd uses timeouts on PDU
exchanges with agents running as processes. By default the timeout
interval is five seconds. The ----tttt option allows an alternative
timeout interval in seconds to be specified. If _t_i_m_e_o_u_t is zero,
timeouts are turned off. It is almost impossible to use the
debugger interactively on an agent unless timeouts have been turned
off for its "parent" ppppmmmmccccdddd.
Once ppppmmmmccccdddd is running, the timeout may be dynamically modified by
storing an integer value (the timeout in seconds) into the metric
ppppmmmmccccdddd....ccccoooonnnnttttrrrroooollll....ttttiiiimmmmeeeeoooouuuutttt via ppppmmmmssssttttoooorrrreeee(1).
----TTTT _m_a_s_k
To assist with error diagnosis for agents and/or clients of ppppmmmmccccdddd
that are not behaving correctly, an internal event tracing mechanism
is supported within ppppmmmmccccdddd. The value of _m_a_s_k is interpreted as a bit
field with the following control functions:
1111 enable client connection tracing
2222 enable PDU tracing
222255556666 unbuffered event tracing
By default, event tracing is buffered using a circular buffer that
is over-written as new events are recorded. The default buffer size
holds the last 20 events, although this number may be over-ridden by
using ppppmmmmssssttttoooorrrreeee(1) to modify the metric ppppmmmmccccdddd....ccccoooonnnnttttrrrroooollll....ttttrrrraaaacccceeeebbbbuuuuffffssss.
Similarly once ppppmmmmccccdddd is running, the event tracing mask may be
dynamically modified by storing 1 (enable) or 0 (disable) into the
metrics ppppmmmmccccdddd....ccccoooonnnnttttrrrroooollll....ttttrrrraaaacccceeeeccccoooonnnnnnnn, ppppmmmmccccdddd....ccccoooonnnnttttrrrroooollll....ttttrrrraaaacccceeeeppppdddduuuu and
/_e_t_c/_c_o_n_f_i_g/_p_m_c_d cccchhhhkkkkccccoooonnnnffffiiiigggg(1M) control flag, to control launching of
ppppmmmmccccdddd from ////eeeettttcccc////iiiinnnniiiitttt....dddd////ppppccccpppp
/_e_t_c/_c_o_n_f_i_g/_p_m_c_d._o_p_t_i_o_n_s
command line options to ppppmmmmccccdddd when launched from
////eeeettttcccc////iiiinnnniiiitttt....dddd////ppppccccpppp All the command line option lines
should start with a hyphen as the first character.
This file can also contain environment variable
settings of the form "VARIABLE=value".
./_p_m_c_d._l_o_g (or $$$${{{{PPPPCCCCPPPP____LLLLOOOOGGGGDDDDIIIIRRRR----////vvvvaaaarrrr////aaaaddddmmmm////ppppccccpppplllloooogggg}}}}////ppppmmmmccccdddd....lllloooogggg when
started automatically)
All messages and diagnostics are directed here
EEEENNNNVVVVIIIIRRRROOOONNNNMMMMEEEENNNNTTTT
PPPPMMMMCCCCDDDD____PPPPAAAATTTTHHHH
A color separated list of directories ppppmmmmccccdddd will search for DSO
agents with relative paths. The default is
/_v_a_r/_p_c_p/_l_i_b:/_u_s_r/_p_c_p/_l_i_b.
PPPPMMMMCCCCDDDD____PPPPOOOORRRRTTTT
TCP/IP port for incoming connections, defaults to 4321.
DDDDBBBBGGGG____TTTTRRRRAAAACCCCEEEE____AAAAPPPPPPPPLLLL2222 for tracing the configuration file scanner and parser.
CCCCAAAAVVVVEEEEAAAATTTTSSSS
ppppmmmmccccdddd does not kill its child agents, it only closes their pipes. If an
agent never checks for a closed pipe it may not terminate.
The configuration file parser will only read lines of less than 1200
characters. This is intended to prevent accidents with binary files.
The timeouts controlled by the ----tttt option apply to IPC between ppppmmmmccccdddd and
the PMDAs it spawns. This is independent of settings of the environment
variables PPPPMMMMCCCCDDDD____CCCCOOOONNNNNNNNEEEECCCCTTTT____TTTTIIIIMMMMEEEEOOOOUUUUTTTT and PPPPMMMMCCCCDDDD____RRRREEEEQQQQUUUUEEEESSSSTTTT____TTTTIIIIMMMMEEEEOOOOUUUUTTTT (see PPPPCCCCPPPPIIIInnnnttttrrrroooo(1))
which may be used respectively to control timeouts for client
applications trying to connect to ppppmmmmccccdddd and trying to receive information